home *** CD-ROM | disk | FTP | other *** search
/ Oh!X 2000 Spring / Oh!X 2000 Spring Special CD-ROM (Japan) (Part 2).7z / Oh!X 2000 Spring Special CD-ROM (Japan) (Part 2).bin / DXMedia / README.TXT < prev    next >
Text File  |  1999-08-20  |  16KB  |  394 lines
  1. Microsoft DirectX Media 6.0 SDK Readme.txt
  2.  
  3. (c)1999 Microsoft Corporation. All rights reserved.
  4. -----------------------------------------------------------------
  5.  
  6. Welcome to the DirectX Media SDK.
  7.  
  8. The DirectX Media 6.0 SDK and runtime shipped on the DirectX 7.0
  9. CD is unchanged from the DirectX Media 6.0 release. New on this CD
  10. is a patch that addresses issues in the DirectX Media 6.0 runtime. 
  11. See redist\dxminstall.txt for more information. This will be the final
  12. release of the DirectX Media SDK and runtime. The next planned release
  13. of DirectShow will be as part of DirectX 8.0. Windows Media
  14. Player is available as a stand-alone release from the Microsoft
  15. web site http://www.microsoft.com. For updated information on
  16. DirectAnimation, refer to the microsoft website
  17. http://www.microsoft.com.
  18.  
  19. This document gives an overview of the product and describes the 
  20. layout of the SDK, installation, and hardware requirements. Be 
  21. sure to review the licensing agreement in License.doc, and its
  22. addendum, Redist.txt.
  23.  
  24. Please see the following sections:
  25.  
  26. - What's New
  27. - Overview
  28. - How to Use the Documentation
  29. - SDK Layout
  30. - Installation
  31. - Hardware and Software Requirements
  32. - Known Issues
  33. - Contact Information 
  34.  
  35. -----------------------------------------------------------------
  36. What's New
  37. ==========
  38.  
  39. - DirectX Media 6.0 Runtime patch
  40.  
  41. New on this CD is a patch that addresses issues in the DirectX 
  42. Media 6.0 runtime. See redist\dxminstall.txt for more information. 
  43.  
  44. - Directory Structure
  45.  
  46. The directory structure for the samples has changed in this 
  47. release to enable future integration with the Microsoft 
  48. Platform SDK. You'll now find the sample source code installed 
  49. in the samples\multimedia\<technology> directory off of your 
  50. DirectX media installation directory. <technology> is 
  51. DShow (DirectShow), DAnim (DirectAnimation), or DTrans 
  52. (DirectX Transform). 
  53.  
  54. - DirectDraw Exclusive Mode Support
  55.  
  56. This release adds support for video playback from within 
  57. applications that are using DirectDraw Exclusive Mode. See 
  58. the DirectShow documentation for the IDDrawExclModeVideo 
  59. interface and the DDRAWXCL sample in the 
  60. Samples\Multimedia\DShow\src\DDrawXCL subdirectory for more 
  61. information. 
  62.  
  63. - Expanded MPEG-2 Support
  64.  
  65. DirectShow has two new filters and two new interfaces to 
  66. support MPEG-2 applications. See the "What's New in the 
  67. DirectShow SDK?" topic in the Getting Started section of the 
  68. DirectShow documentation for more information.
  69.  
  70. - DirectX Transform
  71.  
  72. DirectX Transform is new with this version of DirectX Media.
  73.  
  74. - Documentation
  75.  
  76. See the What's New topics in the Getting Started sections of 
  77. the SDK documentation for specific detailed information about 
  78. these and other new features. 
  79.  
  80. -----------------------------------------------------------------
  81. Overview
  82. ========
  83.  
  84. This release of Microsoft DirectX Media contains the 
  85. following DirectX media run time and SDK components:
  86.  
  87. - DirectShow 
  88. - DirectAnimation
  89. - DirectX Transform
  90.  
  91. For detailed last-minute notes pertaining to these technologies 
  92. see their respective readme files in the DXMedia\Help directory:
  93.  
  94.    ReadmeDAnim.htm - DirectAnimation readme
  95.    ReadmeDShow.htm - DirectShow readme
  96.    ReadmeDTrans.htm - DirectX Transform readme
  97.  
  98. DirectShow
  99.  
  100. DirectShow enables capture of multimedia streams from devices 
  101. and playback of multimedia streams from local files or Internet 
  102. servers. The streams can contain video and audio data compressed 
  103. in various formats, including MPEG, Apple QuickTime, audio-video 
  104. interleaved (AVI), and WAV files. Capture can be based on either 
  105. Video for Windows or Windows Driver Model (WDM).
  106.  
  107. DirectAnimation
  108.  
  109. DirectAnimation provides unified, comprehensive support for 
  110. animation, streaming, and integration of diverse media types, 
  111. such as two-dimensional (2-D) vector graphics, three-dimensional 
  112. (3-D) graphics, sprites, audio, and video. Because it is a 
  113. Component Object Model (COM) API with an underlying engine/run 
  114. time, DirectAnimation functionality can be accessed - in 
  115. different ways - by a wide variety of programmers and authors: 
  116. HTML and scripting authors, and programmers using Java, Visual 
  117. Basic, and Microsoft Visual C++.
  118.  
  119. DirectX Transform
  120.  
  121. DirectX Transform is new with this release. It provides 2-D 
  122. and 3-D image transformations and effects.
  123.  
  124. -----------------------------------------------------------------
  125. How to Use the Documentation
  126. ============================
  127.  
  128. You must have a Web browser to view the SDK documentation. 
  129. Microsoft Internet Explorer 4.01, is recommended for viewing 
  130. HTML files and is required for the new HTMLHelp standard. 
  131.  
  132. The DirectX Media SDK documentation is supplied in two 
  133. formats: HTML and compressed HTML (HTMLHelp). 
  134.  
  135. The HTMLHelp files DXMedia.chm and DXMedia.chi are in the 
  136. subdirectory DXMedia\help within the SDK and contain the 
  137. DirectShow, DirectAnimation, DirectX Transform, and Direct3D 
  138. Retained Mode documentation. The HTMLHelp files require that 
  139. Internet Explorer version 4.01 be installed on the system. 
  140. HTMLHelp files offer features such as full-text search and 
  141. printing of entire chapters that are not available in plain 
  142. HTML.
  143.  
  144. The HTML documentation opening page, Default.htm, is in the 
  145. DXMedia subdirectory within the SDK. You can also bypass this 
  146. opening page and go directly to the default pages of documentation 
  147. that interests you. These default pages can be viewed in any 
  148. browser and are installed in the following directories 
  149. (assuming the default installation directory): 
  150.  
  151.    DirectShow - DXMedia\help\ds\default.htm 
  152.    DirectAnimation - DXMedia\help\da\default.htm 
  153.    DirectX Transform - DXMedia\help\dxt\default.htm
  154.    Direct3D Retained Mode - DXMedia\help\d3drm\default.htm. 
  155.  
  156.    Note: The DirectX Media SDK does not install the Direct3D 
  157.          Retained Mode SDK component as that component is 
  158.          installed by the DirectX Foundation SDK. The DirectX
  159.          Foundation SDK is also supplied on this CD.
  160.  
  161. -----------------------------------------------------------------
  162. SDK Layout
  163. ==========
  164.  
  165. The DirectX Media SDK contains the following top-level 
  166. directories: 
  167.  
  168.    DXMedia - DirectX Media SDK
  169.    Extras - Updated HTMLHelp control for non-Windows 98 systems;
  170.             extra DV and DirectX Transform files
  171.    Redist - Redistributable DirectX Media run tim and optional image 
  172.             transforms
  173.  
  174. -----------------------------------------------------------------
  175. Installation
  176. ============
  177.  
  178. Install the DirectX Media SDK by running 
  179.    
  180.    DXMedia\_setup_\<platform>\setup.exe 
  181.  
  182. where <platform> is x86 or alpha. 
  183.  
  184.  
  185. -----------------------------------------------------------------
  186. Hardware and Software Requirements
  187. ==================================
  188.  
  189. You should have a 486 processor or faster, at least 16 megabytes 
  190. (MB) of RAM, and 200 MB of hard disk space before installing the
  191. DirectX media SDK. If you want to hear the sound in the movies 
  192. and samples, you need a sound card and speakers. If you want to 
  193. do video or audio capture, you need capture equipment. 
  194.  
  195. Your system must include Windows 95 or higher or Windows NT 4.0 
  196. SP3 or higher. 
  197.  
  198. Some features, such as 3-D DirectX Transforms, require the 
  199. DirectX Foundation version 6.0 run-time. DirectAnimation requires 
  200. at least DirectX Foundation version 3.0a for most funtionality. 
  201. See the readme for each technology for details.
  202.  
  203. The documentation and portions of DirectAnimation and DirectX 
  204. Transforms also require Microsoft Internet Explorer version 4.01 
  205. or higher for complete functionality.
  206.  
  207. -----------------------------------------------------------------
  208. Known Issues
  209. ============
  210.  
  211. - DirectX media SDK Setup
  212.  
  213. If you plan to install both the DirectX media SDK and the DirectX
  214. foundation SDK from this CD, be sure to restart your system between 
  215. SDK installations. 
  216.  
  217. Before installing the DirectX media SDK you should uninstall
  218. previous versions of the SDK.
  219.  
  220. Setup on Alpha machines with a removable boot drive is not 
  221. supported.
  222.  
  223. - International install
  224.  
  225. If you install the DirectX media SDK on an international version
  226. of Windows and change the destination directory for the install to
  227. include a 5c trail byte, then setup will appear to proceed 
  228. normally but it will not copy any files. The problem does not 
  229. occur with the default English directory name.
  230.  
  231. - DirectX media run-time setup
  232.  
  233. The system must normally be restarted after installing the DirectX 
  234. media runtime and before playing any multimedia content. See the 
  235. Redistribution Information section (help\ds\Oview\redist.htm) of 
  236. the DirectX media SDK documentation for information about 
  237. installing the DirectX media runtime from an application, 
  238. detecting if a reboot is required, and turning on the run-time's
  239. user interface.
  240.  
  241. Note: The following documented return values for dxmedia.exe 
  242. installations on Windows NT are not currently implemented: 
  243. - ERROR_MEMBER_NOT_IN_GROUP (administrator privileges are required) 
  244. - ERROR_OLD_WIN_VERSION (Windows NT 4.0 service pack 3 is required)
  245. Your installation program should check for these minimum
  246. requirements (administrator privileges and at least Windows NT 4.0
  247. SP3) before installing dxmedia.exe on Windows NT.
  248.  
  249. You might receive an oleaut32.dll error on Windows 95 or OSR2 in 
  250. the Intel Indeo 5 portion of setup. Upgrading to Internet Explorer 
  251. 4.0 or later or installing the latest Indeo 5 codecs 
  252. (http://developer.intel.com/ial/indeo/video/driver.htm) and
  253. then re-installing the DirectX media run-time should eliminate 
  254. the error.
  255.  
  256. - Building samples
  257.  
  258. The DirectX media C/C++ samples build with Microsoft Developer 
  259. Studio version 5.0 and higher. If you build from the command line
  260. be sure your path environment variable lists the most recent
  261. products first. For example, list Microsoft Developer Studio 
  262. before an older edition of the Platform SDK.
  263.  
  264. - DirectShow DVD Sample build error
  265.  
  266. If you get a build error in Developer Studio involving 
  267. SetWindowHookEx when building the DirectShow DVDSampl then 
  268. define STRICT in Developer Studio's pre-processor directives 
  269. (Project Settings, C/C++ tab, Preprocessor category, 
  270. Preprocessor definitions).
  271.  
  272. - Debug version of DirectShow DDrawXcl Sample faults on startup
  273.  
  274. Before building the debug version of the DDrawXcl sample, define 
  275. DEBUG in Developer Studio's pre-processor directives to avoid a 
  276. fault when starting the sample. Note that defining "DEBUG" is 
  277. in addition to defining "_DEBUG" that is already defined. To 
  278. change the pre-processor directives in Developer Studio choose 
  279. Project Settings, C/C++ tab, Preprocessor category, and add 
  280. DEBUG to the Preprocessor definitions edit control.
  281.  
  282. - Unresolved External const bits565 link error 
  283.  
  284. Building the DirectShow Ball and MPGVideo samples with Developer 
  285. Studio version 6.0 produces the following link error.
  286.  
  287.    error LNK2001: Unresolved external symbol 
  288.       "unsigned long const * const bits565" (?bits565@@3QBKB)
  289.  
  290. Rebuilding the DirectShow base classes (provided in the
  291. DirectX media classes\base directory) with Developer Studio
  292. version 6.0 and linking with the resulting strmbase library 
  293. (either debug or retail versions) should fix the problem. 
  294.  
  295. - Documentation
  296.  
  297. We strongly recommend that you have Internet Explorer 4.01 or 
  298. later installed to view the documentation included with this SDK. 
  299. Some features of the documentation such as inline samples might 
  300. not work properly if you do not have Internet Explorer 4.01 or 
  301. later installed. The compressed HTMLHelp files (.CHM) require 
  302. Internet Explorer 4.01 or later and an updated HTMLHelp control. 
  303. The DirectX media SDK setup can update this control for you 
  304. automatically if you have already installed Internet Explorer 
  305. 4.01. Otherwise you can update the control by running HHUpd.exe 
  306. from the Extras directory on the CD.
  307.  
  308. - Compatibility with previous DirectX foundation versions
  309.  
  310. Most features of DirectX media are compatible with DirectX
  311. foundation version 3.0 and higher. By default the ddraw.h header
  312. file from the DirectX foundation SDK is marked with DirectX
  313. version 6.0 compatibility. If you want to build your application 
  314. using the DirectX 6.0 foundation SDK and be compatible with an 
  315. older DirectDraw run-time then define DIRECTDRAW_VERSION to be the 
  316. earliest version of DirectDraw with which you want to be compatible. 
  317. For example if you want your application to run on the DirectX 3
  318. run-time then define DIRECTDRAW_VERSION to be 0x0300 in ddraw.h.
  319.  
  320. Note: The DirectX media SDK no longer ships a version of ddraw.h. 
  321. It used to ship a version marked with DirectDraw 3 compatibility.
  322.  
  323. - DirectX Media and DEBUG DirectX Foundation
  324.  
  325. Due to incompatibilities between ddrawex.dll and the debug version
  326. of ddraw.dll you should not install the debug version of DirectX 
  327. Foundation 6.x if you intend to use any components (for example
  328. DirectAnimation and DirectX Transform) of DirectX Media 6.0.
  329.  
  330. - Optional Transforms Uninstall
  331.  
  332. The Optional DirectX Transforms provide a separate uninstall
  333. option in the Control Panel Add/Remove Programs applet. These
  334. optional transforms are not removed by the DirectX media SDK
  335. uninstall. 
  336.  
  337. - DirectX Transform and Windows NT
  338.  
  339. 3-D DirectX Transforms require the DirectX foundation version 
  340. 6.0 run-time. These transforms will not work on Windows NT 4.0 
  341. since DirectX foundation is not available on Windows NT 4.0.
  342.  
  343. Web pages that use DirectAnimation to display DirectX Transforms 
  344. will not work on Windows NT 4.0 with this release of DirectX 
  345. Media. The DirectX Transform Demo page 
  346. (help\dxt\overview\demos_intro.htm) to which the DirectX Media 
  347. SDK program group points is one such web page.
  348.  
  349. - Internal Protection fault with DirectAnimation and DirectX 5
  350.  
  351. If you encounter a fault in d3drg16f (the DirectX 5 rgb 
  352. rasterizer) when using DirectAnimation, upgrade to DirectX 6. 
  353. The crash is a DirectX 5 D3DIM bug that was fixed in DirectX 6.
  354.  
  355. -----------------------------------------------------------------
  356. Contact Information 
  357. ===================
  358.  
  359. - Support
  360.  
  361. See http://www.microsoft.com/support/ for the product support
  362. options available through Microsoft Technical Support.
  363.  
  364. - Suggestions
  365.  
  366. Email dxmwish@microsoft.com with suggestions for future versions
  367. of the products which have been part of DirectX Media. We cannot
  368. guarantee replies to all of your suggestions, but we will
  369. carefully consider all ideas.  We appreciate your input.
  370.  
  371. - Redistribution
  372.  
  373. Be sure to read the license agreement for redistribution 
  374. information concerning the DirectX Media Run-time.
  375.  
  376. We'd like to get to know you and your product better. Email 
  377. dxmrdist@microsoft.com to let us know you're shipping our 
  378. run-time. We can perform compatibility testing of your product 
  379. with our future versions to help ensure backwards compatibility.
  380.  
  381. Include information such as your contact information (name, 
  382. company name, phone/fax, shipping address), company 
  383. focus (web development, games, content creation, etc.), 
  384. product name, and a list of the DirectX Media technologies, 
  385. versions, and tools you're using. Knowing who's using our 
  386. technology helps us better meet your needs. 
  387.  
  388. DirectX Beta Program
  389.  
  390. For enrollment in future DirectX beta programs, contact
  391. DirectX@Microsoft.com. The beta coordinator will send you
  392. a non-disclosure agreement and ensure we have your contact 
  393. information. 
  394.